<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">











<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>NPanday - Setting up an Artifact Repository</title>
    <style type="text/css" media="all">
      @import url("../../css/maven-base.css");
      @import url("../../css/maven-theme.css");
      @import url("../../css/site.css");
    </style>
    <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
          </head>
  <body class="composite">
    <div id="banner">
                  <a href="" id="bannerLeft">
    
                                            <img src="../.././images/NPanday.png" alt="" />
    
            </a>
                        <a href="http://www.codeplex.com/" id="bannerRight">
    
                                            <img src="../.././images/logo-home.png" alt="" />
    
            </a>
            <div class="clear">
        <hr/>
      </div>
    </div>
    <div id="breadcrumbs">
          
  

  
    
            
  
    
            <div class="xleft">
          
                <a href="http://npanday.codeplex.com/" class="externalLink">NPanday Home</a>
                &gt;
      
                <a href="../../">NPanday 1.2</a>
                  </div>
            <div class="xright">      
  

  
    
            
  
    
             Last Published: 22 Jun 2010
              &nbsp;| Version: 1.2
            </div>
      <div class="clear">
        <hr/>
      </div>
    </div>
    <div id="leftColumn">
      <div id="navcolumn">
           
  

  
    
            
  
    
                   <h5>General Info</h5>
            <ul>
              
    <li class="none">
                    <a href="../../index.html">NPanday Overview</a>
          </li>
              
    <li class="none">
                    <a href="../../release-notes.html">NPanday Release Notes</a>
          </li>
              
    <li class="none">
                    <a href="../../faqs.html">NPanday FAQs</a>
          </li>
              
    <li class="none">
                    <a href="../../faqs.html">NPanday Features</a>
          </li>
              
    <li class="none">
                    <a href="../../npanday.pdf">Documentation PDF</a>
          </li>
          </ul>
              <h5>User's Guide</h5>
            <ul>
              
    <li class="none">
                    <a href="../.././guide/index.html">Introduction</a>
          </li>
              
    <li class="none">
                    <a href="../.././guide/installation/index.html">Installation</a>
          </li>
              
    <li class="none">
                    <a href="../.././guide/vs/index.html">Visual Studio Add-in</a>
          </li>
              
    <li class="none">
                    <a href="../.././guide/maven/index.html">Maven Command Line</a>
          </li>
              
    <li class="none">
                    <a href="../.././guide/devinfra/index.html">Maven Development Infrastructure</a>
          </li>
              
    <li class="none">
                    <a href="../../plugins/index.html">NPanday Plugins</a>
          </li>
          </ul>
              <h5>Contributing</h5>
            <ul>
              
    <li class="none">
                    <a href="../.././developers/index.html">Developer's Guide</a>
          </li>
              
    <li class="none">
                    <a href="../.././issue-tracking.html">Issue Tracking</a>
          </li>
              
    <li class="none">
                    <a href="../.././mail-lists.html">Mailing Lists</a>
          </li>
          </ul>
              <h5>Project Documentation</h5>
            <ul>
              
                
              
      
            
      
            
      
            
      
            
      
            
      
            
      
              
        <li class="collapsed">
                    <a href="../../project-info.html">Project Information</a>
                </li>
          </ul>
              <h5>Resources</h5>
            <ul>
              
    <li class="none">
                    <a href="http://maven.apache.org/" class="externalLink">Apache Maven</a>
          </li>
              
    <li class="none">
                    <a href="http://npanday.codeplex.com/" class="externalLink">NPanday on CodePlex</a>
          </li>
          </ul>
                                           <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
            <img alt="Built by Maven" src="../../images/logos/maven-feather.png"></img>
          </a>
                       
  

  
    
            
  
    
        </div>
    </div>
    <div id="bodyColumn">
      <div id="contentBox">
        <div class="section"><h2>Setting up an Artifact Repository</h2>
<p>Setting up an artifact repository is highly recommended for working with NPanday and Maven projects in general.</p>
<p>In this example, we configure <a class="externalLink" href="http://archiva.apache.org/"> Apache Archiva</a>, however other repository managers will operate similarly. Instructions on installing Archiva can be found on the <a class="externalLink" href="http://archiva.apache.org/docs/1.3/quick-start.html"> Archiva web site</a>.</p>
<div class="section"><h3>Creating an NPanday repository</h3>
<p>Logged in as the administrator created when installed, go to the <i>Repositories</i> tab and add a new managed repository. Use the following values:</p>
<ul><li><i>Identifier</i>: <tt>npanday</tt></li>
<li><i>Name</i>: NPanday Repository</li>
<li><i>Location</i>: the path where the NPanday release repository was unpacked on your machine</li>
</ul>
<p>After adding this, you may be prompted due to the content already existing - you can safely request to continue.</p>
<p>Next, you will need to go to the <i>Users</i> tab and select the <tt>guest</tt> user, and follow the screens to allocate them with <i>Repository Observer</i> permission for the <tt>npanday</tt> repository to allow it to be accessed without a username and password.</p>
<p>This will make all of the NPanday artifacts available at <a class="externalLink" href="http://localhost:8080/archiva/repository/npanday/">http://localhost:8080/archiva/repository/npanday/</a>.</p>
</div>
<div class="section"><h3>Configuring Maven to use the NPanday repository</h3>
<p>You will next need to configure Maven to use this remote repository. This can be done using the instructions shown on the Archiva web site, <a class="externalLink" href="http://archiva.apache.org/docs/1.3/userguide/using-repository.html"> Configuring Maven 2 to use an Archiva repository</a>.</p>
</div>
<div class="section"><h3>Proxying Future Releases</h3>
<p>An alternative to downloading the releases from the Codeplex site is to automatically obtain them from the NPanday repository on demand using Archiva's repository proxy feature.</p>
<p>To do so, first go to the <i>Repositories</i> tab and add a new <i>remote</i> repository (below the <i>managed</i> repositories at the top). The fields used will be:</p>
<ul><li><i>Identifier</i>: <tt>npanday.remote</tt></li>
<li><i>Name</i>: NPanday Remote Repository</li>
<li><i>URL</i>: <a class="externalLink" href="http://repo.npanday.org/archiva/repository/npanday-group">http://repo.npanday.org/archiva/repository/npanday-group</a></li>
</ul>
<p>After this is added, you can connect the previous <tt>npanday</tt> repository with the <tt>npanday.remote</tt> repository using a proxy connector. You can find more information on the Archiva web site, under <a class="externalLink" href="http://archiva.apache.org/docs/1.3/adminguide/proxy-connectors.html"> Understanding Proxy Connector Configuration of Apache Archiva</a>.</p>
</div>
<div class="section"><h3>Separate NPanday Release Repository</h3>
<p>The above techniques provide repositories that contain not only the NPanday releases, but also all of the artifacts it depends on.</p>
<p>Alternatively, you can configure NPanday releases into a single managed repository, and other dependencies in separate repositories.</p>
<p>For the NPanday releases, they can be obtained as above either from the <tt>npanday</tt> subdirectory of the downloaded repository, or from the remote URL: <a class="externalLink" href="http://repo.npanday.org/archiva/repository/npanday-releases">http://repo.npanday.org/archiva/repository/npanday-releases</a>.</p>
<p>For the dependencies, there are two needs:</p>
<ul><li>the Open RDF repository, which can be proxied from <a class="externalLink" href="http://repository.aduna-software.org/maven2">http://repository.aduna-software.org/maven2</a>. Only the <tt>info/aduna/**</tt> and <tt>org/openrdf/**</tt> artifacts need to be proxied.</li>
<li>3rd party .NET dependencies. Some can be obtained from <a class="externalLink" href="http://repo.npanday.org/archiva/repository/3rdparty/">http://repo.npanday.org/archiva/repository/3rdparty/</a>, or they can be uploaded manually to your own managed repository. Currently, only NUnit is included there.</li>
</ul>
</div>
</div>

      </div>
    </div>
    <div class="clear">
      <hr/>
    </div>
    <div id="footer">
      <div class="xright">&#169;  
          2010
    
          NPanday
          
  

  
    
            
  
    
  </div>
      <div class="clear">
        <hr/>
      </div>
    </div>
  </body>
</html>
